home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / wordproc / hshell1.arj / QREF.DOC < prev    next >
Text File  |  1993-12-29  |  75KB  |  1,939 lines
  1. HyperShell Version 5 - Quick Reference Guide
  2.  
  3.  
  4. HyperShell Hypertext control system Version 5.0 Quick Reference Guide
  5. Copyright (c) 1989,1990,1991,1992,1993 Text Technology
  6. _______________________________________________________________________
  7.  
  8.  
  9.        CONTENTS Page
  10.  
  11. 1.     Hyperfile Structure
  12. 2.     HyperShell Directives
  13. 3.     Print Directives
  14. 4.     Check directives
  15. 5.     References
  16. 6.     Formatting flags
  17. 7.     System variables
  18. 8.     Pseudo variables
  19. 9.     Application variables
  20. 10.    Limits
  21. 11.    Actions
  22. 12.    Extended action codes
  23. 13.    Bitmap sublanguage commands [G]
  24. 14.    Draw Sublanguage commands [G]
  25. 15.    Graphic hook variables [G]
  26. 16.    Parameters on actions
  27. 17.    Key specifications
  28. 18.    Action modifiers
  29. 19.    Dynamic menus
  30. 20.    Contents lists
  31. 21.    Iterators
  32. 22.    Function codes
  33. 23.    Expression operators
  34. 24.    Script control structures
  35. 25.    Conversion string commands
  36. 26.    Pattern Match operators
  37. 27.    Conditions
  38. 28.    Reserved characters in Actions
  39. 29.    Options
  40. 30.    Extended options
  41. 31.    Colour schemes
  42. 32.    Colour codes
  43. 33.    Configuration strings
  44. 34.    Control menu
  45. 35.    Error codes
  46. 36.    Edit actions
  47. 37.    Extra dynamic menus
  48. 38.    Flags in lists
  49. 39.    Extra Functions
  50. 40.    Environment options
  51. 41.    Edit mode primitive function codes
  52. 42.    Graphics symbol shift character mappings
  53. 43.    Default Key Mappings
  54. 44.    Control Keys
  55. 45.    Function Keys
  56. 46.    HS - HyperShell Reader
  57. 47.    HI - HyperShell Integrated Environment
  58. 48.    HC - HyperShell Checker
  59. 49.    HP - HyperShell Print program
  60. 50.    HCX - HyperShell Compress program
  61. 51.    TAGBLOAD - image tagger
  62. 52.    HYPOP - HyperShell subset popup program
  63. 53.    HRXFP - HyperShell Floating Point
  64. 54.    NGHS - Norton Guide to hyperfile convertor
  65. 55.    NOTE - Simple note editor
  66. 56.    HSORT - Hyperfile index sort
  67. 57.    HSHOW - Graphic file display program
  68. 58.    HPREP - Text preparation program
  69. 59.    HSPELL - Hyperfile spell check
  70. 60.    HFIND - File and text finder
  71. 61.    HTYPE - File browser
  72. 62.    HSRES - Resident swapper for HyperShell
  73. 63.    HPAINT - Paint program
  74. 64.    HRESED - Resource editor
  75. 65.    HGPREP - HyperShell Graphic Preparation
  76. 66.    HCOMP - Compression control
  77. 67.    HLIB - Command line
  78. 68.    HCAP - capture screens
  79. 69.    HFONT - Load font file for text mode
  80. 70.    HPG - Graphic print
  81. 71.    CONVSND - Convert sound file
  82. 72.    CTAUDIO - Compact Disc Audio control
  83. 73.    HyperShell File Extensions
  84.  
  85. Key:
  86.  
  87. [IDE]   Integrated Development Environment only
  88. [G]     Graphic version only (HG.EXE, HGI.EXE, HDG.EXE)
  89.  
  90.  
  91. 1. Hyperfile Structure
  92.  
  93.   ┌───┐  ┌───┐  ┌───────────────┐  ┌─────────────────────────────┐
  94.   │ H │  │ G │  │ CONTROL ITEMS │  │ INDEX, HEADER, FOOTER, ETC. │
  95.   │   │  │ L │  └───────────────┘  └─────────────────────────────┘
  96.   │ Y │  │ O │  ┌───────────────┐  ┌─────────────────────────────┐
  97.   │   │  │ B │  │ G E N E R A L │  │ N O T E S                   │
  98.   │ P │  │ A │  │               │  │ M E N U S                   │
  99.   │   │  │ L │  │  I T E M S    │  │ S C R I P T S               │
  100.   │ E │  │ S │  │               │  │ R E M A R K S               │
  101.   │   │  │   │  │               │  │ PRINT AND CHECK             │
  102.   │ R │  └───┘  └───────────────┘  └─────────────────────────────┘
  103.   │   │  ┌───┐  ┌───────────────┐  ─────  ┌──────────────────────┐
  104.   │ F │  │ F │  │ F R A M E     │         │ FRAME, TITLE, TEXT   │
  105.   │   │  │ R │  │  S P E C      │         └──────────────────────┘
  106.   │ I │  │ A │  └───────────────┘  ──┐    ┌──────────────────────┐
  107.   │   │  │ M │  ┌───────────────┐    │    │ L O C A L  I T E M S │
  108.   │ L │  │ E │  │ F R A M E     │    │    │ N O T E S            │
  109.   │   │  │ S │  │  S P E C      │    │    │ M E N U S            │
  110.   │ E │  │   │  └───────────────┘    │    │ S C R I P T S        │
  111.   └───┘  └───┘     - etc -           └──  └──────────────────────┘
  112.  
  113. 2. HyperShell Directives
  114.  
  115. .REMARK                           Remark section
  116. .PRINT directives                 HP control
  117. .CHECK settings                   HC control
  118. .NOTE name                        Global/Local Note
  119. .MENU name                        Global/Local Menu
  120. .SCRIPT name                      Global/Local Script
  121. .HEADER                           Screen header
  122. .FOOTER                           Screen footer
  123. .INDEX                            Create .HIX file
  124. .SHARE                            Shared globals
  125. .FRAME name                       Frame name
  126. .TITLE title text                 Frame title
  127. .END                              End of frame spec.
  128.  
  129. 3. Print Directives
  130.  
  131. .PRINT TITLE                      Next line is title
  132. .PRINT FOOT                       Next line is footer
  133. .PRINT OFF                        Disable print
  134. .PRINT ON                         Enable print
  135. .PRINT PAGE                       Page break
  136. .PRINT THIS                       Following text is printed
  137. .PRINT SECTION prefix             Prefix for numbering
  138. .PRINT MARGIN nn                  set frame margin (for ~i flag)
  139. .PRINT WPOFF                      Disable -w flag
  140. .PRINT WPON                       Enable -w flag
  141. .PRINT LIMIT nnnn                 Frame limit for encrypted file
  142. .PRINT LIMIT g                    Suppress glossary for encrypted
  143.  
  144. 4. Check directives
  145.  
  146. .CHECK +a - check actions in menus with actions
  147. .CHECK +f - check frame refs for menus without actions
  148. .CHECK +p - suppress frame length check
  149. .CHECK +u - suppress errors for unresolved references
  150. .CHECK +x - suppress menu length check
  151.  
  152.  
  153. 5. References   
  154.  
  155.  ~?ref text{~Paction}{~Kk}~E - reference(type(name){,action{,key}})
  156.       Where ? is :-
  157.  
  158. ~A    Action                    actionref(ref{,action}{,k})
  159. ~F    Frame reference           frameref(name{,action}{,k})
  160. ~f    Frame step
  161. ~I    Input field               inputfield(field,pattern{,k})
  162. ~M    Global menu               menuref(name{,action}{,k})
  163. ~m    Local menu
  164. ~N    Global note               noteref(name{,action}{,k})
  165. ~n    Local note
  166. ~S    Global script             scriptref(name{,action}{,k})
  167. ~s    Local script
  168. ~t    File note
  169. ~R    [G] Graphic reference
  170.  
  171. 6. Formatting flags
  172.  
  173. ~a     Mark top left of area
  174. ~Bc    Background colour                             background(colour)
  175. ~bn    Set bottom right position, draw area as per n   box(type)
  176.        0 - Just return to position set by ~a           _return
  177.        1 - Draw box from ~a position                   _double
  178.        2 - Define text window and clear it             _window
  179.        3 - Draw box with window inside and clear       _windowbox
  180.        Above values +4 - reset text window to full screen
  181. ~Cnn   Column (1-78)                                    column(number)
  182. ~c     Concatenate with next line (stops line break)
  183. ~Ds    Colour Scheme (A-Z)                              scheme(letter)
  184. ~d     Toggle slow (teletype) display            
  185. ~G     Screen break
  186. ~g     Line break        
  187. ~H     Hidden line                    
  188. ~hc    Line/text shown if condition true                showif(c)
  189. ~in    Set indent at 'n' spaces (default 0)             indent(by)
  190. ~Jn    Set local flag                                   setlocal(flag)
  191. ~jc    Line/text hidden if condition true               hideif(c)
  192. ~Lnn   Line (1-22)                                      linepos(number)
  193. ~On    Option setting (0-9,other chars,#)     
  194. ~p     Do not PRINT rest of this line
  195. ~Q     Immediate reference (after reference)
  196. ~Tc    Text colour                                      foreground(colour)
  197. ~Vi    Video intensity            
  198. ~Wnn   Field width (1-72)                               width(number)
  199. ~wn    Wait n seconds before continuing                 wait(seconds)
  200. ~Xnn   Column (1-78) (forced)                           xpos(number)
  201. ~Ynn   Line (1-22) (forced)                             ypos(number)
  202. ~Z     End of region
  203. ~z     [G] terminate sunlanguage command
  204. ~e     [G] terminate command and stop reference (also ~R...~E)
  205. ~vx    [G] Change font to nn (x=A for nn=1,@ for 0)
  206. ~Ux    [G] Do bitmap sublanguage command in variable GUx
  207. ~ux    [G] Do draw sublanguage command in variable Gux
  208.  
  209. 7. System variables
  210.  
  211. $0    HyperShell program pathname                  _progpath
  212. $1    Current frame name                           _frame
  213. $2    Current frame title                          _title
  214. $3    Current file name                            _hyperfile
  215. $4    Current date                                 _date
  216. $5    Current time                                 _time
  217. $6    Backtrack list depth                         _depth
  218. $7    Current directory                            _curdir
  219. $8    Original directory                           _original
  220. $9    HyperShell name and version                  _hypershell
  221. $?    Error number of last error                   _errnum
  222. $@    Remaining memory                             _memory
  223. $_    File prompt                                  _fprompt
  224. $^    Program exit code                            _exitstatus
  225. $:    Exclusion list of file extns                 _exclusions
  226. $<    Filename from directory display              _filename
  227. $>    File extension from directory                _filetype
  228. $`    Error status change action                   _erroraction
  229. $\    Parameter to Script or Note                  _parameter
  230. $~    Pattern match translation string             _pattrans
  231.  
  232. 8. Pseudo variables
  233.  
  234. $,        represents ';' character                 _semi
  235. $!        represents '|' character                 _bar
  236.  
  237. 9. Application variables
  238.  
  239. $A to $Z   application variables
  240. $a to $z   application variables
  241. $(xxxxxx)  named application variable
  242. $(%NAME)   value of environment variable
  243. $(=expr)   value of expression
  244. $(&func)   value of function
  245.  
  246. 10. Limits
  247.  
  248. Reference text                  - 40 chars
  249. Reference action                - 40 chars
  250. References in frame (+ note)    - 100
  251. Note text                       - 76 chars by 22 lines
  252. Frame text                      - 80 chars
  253. Menu choices                    - 20 per page
  254. Script lines                    - 80 chars by 200
  255. (expanded) action string        - 120 chars
  256. multiple action string          - 120 chars
  257.  
  258. 11. Actions
  259.  
  260. Aaction    do action 'action'                 action(action)
  261. acaction   do 'action' on condition 'c'       ifcond(c,action)
  262. B          backtrack one frame                backtrack()
  263. bn         backtrack to depth n               backto(depth)
  264. Cd:d       Change drive/directory             changeto({d:}dir)
  265. cfile      interpret file as script           call(scriptfile)
  266. Dcommand   Dos shell command                  dodos(command,wait)
  267. dcommand   Dos shell command (no wait)        dodos(command{,quiet})
  268. Ecommand   Execute command (no return)        execute(command,over)
  269. evsabc..   Split v on s to a,b,c etc.         expand(v,s,abc...)
  270. Fname{^hf} Go to frame {in hyperfile}         frame(name)
  271. fname{^hf} Go to frame (no backtrack)         framestep(name)
  272. Gfile      Display graphic file               graphic(file)
  273. gfile      Display graphic and stay in mode   graphic(file,hold)
  274. Href~comm  Add note to notepad {with comment}   addref(ref)
  275. href       Remove note from notepad           delref(ref)
  276. I{#}       Select next{current} input field   nextinput({this})
  277. itext      Insert text at text cursor         insert(text)
  278. Jlabel     Unconditional jump                 goto(label)
  279. jclabel    Conditional jump                   goto(c,label)
  280. Kkkact     Map key kk to action               mapkey(key,action)
  281. kkkaction  Do action mapped to key            dokey(key)
  282. Llabel     Label name - in script.            label(name)
  283. lvnamed    Load named var from var v          loadvar(v,name)
  284. Mname      Global menu                        menu(name)
  285. mname      local menu                         localmenu(name)
  286. Nname      Global note                        note(name)
  287. nname      local note                         localnote(name)
  288. Oos        Set option / colour                setopt(opt,val)
  289. ostring    Output to printer etc.             output(string)
  290. Pstring    Popup message                      popmessage(string)
  291. pstring    Display message on bottom line     display(string)
  292. Qss        Quit to DOS                        quit(status)
  293. q          Quit script                        quitscript()
  294. Rsabc..    Read file (formatted)              read(s,abc...)
  295. rfilenm    Open file for reading (close)      openin(file), closein()
  296. Sname      Global script                      script(name)
  297. sname      local script                       localscript(name)
  298. Tfilenm    Type file                          typefile(file{,string})
  299. tfilenm    Display file as popup note         filenote(filename)
  300. Vxvalue    Set variable x to value            setvar(v,value)
  301. vxvalue    Test variable x                    testvar(v,value)
  302. Wstring    Write string to file               write(string)
  303. wfilenm    Open file for writing (close)      openout(file), closeout()
  304. Xcomm      Execute command                    execute(command,wait)
  305. xcomm      Execute command (no wait)          execute(command)
  306. Y          Reset error status to 0            reseterr(value)
  307. y{+/#/-}   Display next,current,prev screen   refresh(ind)
  308. Zxa        Extended action code  (see below)
  309. zcaction   Do 'action' if 'c' false           ifnot(c,action)
  310.  
  311.  
  312. 12. Extended action codes
  313. ZAkey:action - Specified autoref                autoref(key,action)
  314. Za           - Autoreference search string
  315. ZB           - Beep (sound bell)                beep(param)
  316. Zbn          - 0=Bright,1=Blink Background      blinkback(status)
  317. ZC           - Display control menu             control()
  318. Zcnn string  - Set config string nn to string
  319. ZDpattern    - [G] Delete set of named vars
  320. ZE           - Exit subroutine                  return()
  321. ZFn          - Reserve footer lines             reserve(lines)
  322. ZG           - Refresh &X,&Y coords             getxy()
  323. Zg           - Get graphics mouse selection     getseln()
  324. ZH           - Hold start position of loop      holdline()
  325. ZIexpr       - If expr TRUE (+ve), do multiact  if(expr)
  326. Ziexpr       - If expr non-zero, do multiaction
  327. ZJlabel      - Jump to Subroutine               gosub(label)
  328. ZLn{s}       - Toggle frame local flag          toggle(flag,noref)
  329. Zlc{i}       - Set local flag for contents ind. localind(flag,ind)
  330. ZMn          - Set text mode (n = 3 or 64)      textmode(mode)
  331. Zmnn         - Set message line number (25)
  332. ZNfilename   - Write noted references to file
  333. Zo{t}        - Print current frame {with name/title}
  334. ZPfile       - Preload hyperfile                preload(hyperfile)
  335. ZR           - Recall saved screen              recall()
  336. Zr           - Reset text window to full screen resetwindow()
  337. ZSev=string  - Set environment variable         setenv(var,value)
  338. ZT           - Take copy of whole screen        takecopy()
  339. Zt           - Show copied screen /clear screen  showcopy()
  340. ZUc{tt}      - Load character as input {timeout}   unget(c)
  341. ZVname=value - Assign named variable            assign(name,value)
  342. ZW           - [IDE] write to debug trace file
  343. Zw{filename} - [IDE] {open}/close debug trace file
  344. ZXnn         - Set mouse cursor column          setmousex(xpos)
  345. ZYnn         - Set mouse cursor line            setmousey(ypos)
  346. ZZ           - [G] Graphic bitmap sublanguage
  347. Zz           - [G] Graphic draw sublanguage
  348.  
  349. 13. Bitmap sublanguage commands [G]
  350.  
  351. A       Load image as mouse cursor (arrow)
  352. B       Position image at box top position - set by ~a
  353. C       Get image from last reference selected to general save area
  354. D       Load and decompress image (saved with S or X) to general save
  355. E       'Soft' extract - extract if not already loaded
  356. F       Load file as font in CHARBIOS (needs CHARBIOS loaded)
  357. G       Get image from screen to general save area
  358. H       Play file as sound through IBMSND.COM driver
  359. I       Invert image (see also +)
  360. J       Load image as 256 colour screen (in mode 19 only)
  361. K           - reserved -
  362. L       Load image from memory with name = item
  363. M       Position image at mouse cursor = top left
  364. N           - reserved -
  365. O       Open library file with name = item  (eg. ZZO^GLIB.HLB)
  366. P       Put image to screen
  367. Q       Test to see if CHARBIOS is loaded, and report an error if not
  368. R       Read image from file (filename = item) to general save area
  369. S       Save image to memory with name = item
  370. T       Position image at current text cursor = top left
  371. U       Load file as 16 colour palette (uses .PAL files)
  372. V       Read image and save in variable of same name
  373. W       Write image to file (filename = item)
  374. X       Extract item from library with name = item and store
  375. Yx      Tell CHARBIOS to load font x from file (see ~vx description)
  376. Z       Sleep - Wait for 20ms
  377. +n      Displace image downwards by n pixels (see also I)
  378. 1       Specify default image display command string (see section below)
  379. 2       Supply pattern for auto-purge of named variables
  380.  
  381. 14. Draw Sublanguage commands [G]
  382.  
  383.   cccc   - colour sequence
  384.   X      - exclusive or the following commands
  385.   Hnnn   - set horizontal coord (x)
  386.   hnnn   - set horizontal coord 2 (x) (default is last coord)
  387.   Vnnn   - set vertical coord (y)
  388.   vnnn   - set vertical coord 2 (y)  (default is last coord)
  389.   P      - set coordinates to mouse pixel coordinates
  390.   Ldnnncccc   - horiz/vert lines
  391.         d   = direction
  392.         nnn = repeat
  393.         ccc = colour sequence
  394.   lc     - draw line from coord 2 to specified coord
  395.         eg. draw green line from last graphic position to 200,100
  396.             ZzH200V100lG
  397.   directions
  398.                 7  8  9
  399.                  \ | /
  400.                4 -   - 6
  401.                  / | \
  402.                 1  2  3
  403.  
  404.   colour sequence
  405.   -     Colour letters as per HyperShell colour values
  406.         eg. rrr    is three bright red pixels
  407.   -     T   - transparent pixel (leave screen pixel as is)
  408.   -     ,   comma - "carriage return / line feed"
  409.   -     '   quote - vertical "carriage return / line feed"
  410.   -     .   point - "carriage return"
  411.             These allow a sequence of raster lines to be drawn
  412.             in the required direction
  413.  
  414. 15. Graphic hook variables [G]
  415.  
  416.   Bitmap Sublanguage command strings
  417.       GXR   Reference selection
  418.       GUx   executed by ~Ux
  419.       GXN   Font for use in popup note
  420.       GXM   Font for use in popup menu
  421.       GXT   Font for use in main text
  422.       GXP   Font for display of popup note
  423.       GMx   Mouse cursor, where x is one of the standard
  424.             reference flag letters - A,F,M,S,N or R.
  425.       GMT   Mouse cursor to that used for open text.
  426.  
  427.   Draw Sublanguage command strings
  428.       Gux   executed by ~ux
  429.  
  430. 16. Parameters on actions
  431.   -- on Frame actions F and f --
  432. Fname          Named frame (normal frame selection)
  433. F              Home frame (first in file)
  434. F+             Next frame (wrap at end)
  435. F+1            Next matching frame
  436. F+2            Next unmatched frame
  437. F+name         Next named (duplicates)
  438. F-             Previous frame (wrap at start)
  439.   -- on M,m,F --
  440. Mmenu name(option number)         Specified option
  441. Mmenu name[lookup key / pattern]  Lookup value
  442. Mmenu name[@]                     Graphics selection zone action
  443.   -- on N,n,t,S,s,c --
  444. Nnote name(parameters)            Set variable $\
  445. Sscript name(parameters)          Set variable $\
  446.   -- on T --
  447. Tfilename/string       Type file, searching for string
  448.                        If string starts '^' it is a pattern
  449. Tfilename#nn           Type file, starting at page nn
  450. Tfilename#nn/string    Type file at page nn and highlight string
  451.  
  452. 17. Key specifications
  453.  
  454. (kk = F1-F0,S1-S0,A1-A0,C1-C0,#x)
  455.  
  456.  
  457. 18. Action modifiers
  458.  
  459. ?prompt       Prompt for value               prompt(prompt)
  460. ?prompt/deflt Prompt giving value to edit    prompt(prompt,default)
  461. %envvar       Use value of env. var          getenv(variable)
  462. &funcspec     Use function return
  463. @menuspec     Use menu return                from(menuspec)
  464. !readspec     Iterators (read file etc)
  465. =expr         Integer/boolean expression
  466.  
  467. 19. Dynamic menus
  468.  
  469. @B           Backtrack list for unwind       unwind()
  470. @b           Backtrack list for revisit      revisit()
  471. @C{n}{key}   Current contents list           contents(n,key)
  472. @Dwildspec   Directory list (no extn)        popdir(wild,noext)
  473. @dwildspec   Directory list (with extn)      popdir(wild)
  474. @Ewildspec   Directory (directories)         popdirs(wild)
  475. @Ffilename   Contents of file as menu        filemenu(filename)
  476. @Gfilename   Formatted file list             datalist(filename)
  477. @Lwildspec   Extended directory display      directory(wildcard)
  478. @lwildspec   Extended dir with actions       diraction(wildcard)
  479. @M/mname     Global/local menu               from(menu(name)) etc.
  480. @N/n/tname   Global/local/file note          from(note(name)) etc.
  481. @Oxxx        Named vars starting xxx as menu
  482. @R           Notepad paged list              notepad()
  483. @Sstring     Search titles of current file   search(title,string)
  484. @sstring     Search titles of open files     search(alltitle,string)
  485. @Xstring     Search titles/texts current     search(text,string)
  486. @xstring     Search titles/texts open fls    search(alltext,string)
  487.  
  488. 20. Contents lists
  489.  
  490. @C{0}{key}    Full list {starting with key}    full(key)
  491. @C1{key}      Matching frames { " }            matched(key)
  492. @C2{key}      Unmatched frames { " }           unmatched(key)
  493. @C3key        Start list at frame "            startat(key)
  494. @C4key        Titles starting with key         titlekey(key)
  495. @C4^pattern   Titles containing pattern        titlekey(key)
  496. @C5key        Start at title starting key      starttitle(key)
  497. @C5^pattern   Start at title containing pattern  starttitle(key)
  498.  
  499. 21. Iterators
  500.  
  501. !{key}        Read next {matching} record     readrec(key)
  502. !F{key}       Read next {matching} record     readnext(key)
  503. !L{key}       Read first {matching} record    lookuprec(key)
  504. !Bkey         Fast lookup (sorted text files) fastlookup(key)
  505. !C            Next comment                    comment(key)
  506. !R{key}       Next {matching} reference       nextref(key)
  507. !Dwildcard    First matching filename         firstfile(wildcard)
  508. !D            Next matching filename          nextfile()
  509. !Ppos         Position at byte 'pos' and return line
  510. !Sstring      Search for first string and return record
  511. !Nstring      Search for next string in file
  512.  
  513. 22. Function codes
  514.  
  515. &Ac     - ASCII value of 1st char              asc(c)
  516. &an     - Name of frame number n
  517. &Bp     - Scale value to p decimal places      scale(p,value)
  518. &bc     - [G] get graphic information (pixel level)
  519.           x     current graphic draw x coord
  520.           y     current graphic draw y coord
  521.           X     mouse x coord
  522.           Y     mouse y coord
  523.           M     current mode (as set by ZM action)
  524.           C     character cell height
  525. &Cn     - Character of ASCII value nn          chr(nn)
  526. &cparam - HyperShell Resident Extension        hrx(param)
  527. &D      - Display (0-CGA,1-MDA,2-EGA,3-VGA)    adaptor()
  528. &dxnn   - String of length nn of character x
  529. &Ekk    - Extended key mapping                 mapping(kk)
  530. &enn    - Edit and get text of length nn
  531. &Fcss   - String from character c onwards      fromchar(c,ss)
  532. &f{d}   - [IDE] Free space on cur{named} drive diskfree(d)
  533. &f{#}   - [IDE] return space on {hyperfile} disk
  534. &Gtt    - Get key with timeout                 keytimed(timeout)
  535. &gnn    - Get text of length nn at text cursor
  536. &H      - Time of day as hundredths            timehun()
  537. &hcomm  - Add ref for matched frames, with comment
  538. &Icss   - Position of char c in string ss      instr(c,ss)
  539. &i{def} - input string at text cursor position textin(default)
  540. &J      - Time difference (hundredths)         timediff()
  541. &jname  - Sequence number of frame 'name'
  542. &Kss    - Key pressed from popup prompt        getkey(message)
  543. &kc     - Clear all local condition c flags
  544. &Lss    - Length of string ss                  length(ss)
  545. &l      - [IDE] Size of current hyperfile      filesize()
  546. &Mk     - String mapped to key k               mapone(k)
  547. &mss    - Frame with title containing ss
  548. &Nnss   - nth character in string ss. **       nthchar(n,ss)
  549. &n      - Current page number in frame
  550. &OX     - Application flag value (X=A-Z)       flagval(flag)
  551. &oX     - Numeric attribute of colour scheme X
  552. &P      - Pick word at mouse cursor            pickword()
  553. &pn     - Last typed file parameters           typedparam(n)
  554. &Qn     - Pick reference action at mouse       pickref(n)
  555. &q      - Wait for key press return ASCII code
  556. &Rnn    - Run option value (nn = 0 to 21)      optval(nn)
  557. &Snss   - Substring of ss starting nth. **    frompos(n,ss)
  558. &sname  - Local flag mask of frame 'name'
  559. &Tss    - Title of frame with name ss          title(frame)
  560. &t      - Name of last(current) typed file     typedfile()
  561. &Ucss   - String up to character c             upto(c,ss)
  562. &unss   - First n characters of string ss. **
  563. &Vnn    - Configuration string nn              configval(nn)
  564. &vv     - Variable address as far pointer      varptr(v)
  565. &Wss    - Whole string (guard)                 whole(ss)
  566. &wn     - Details of last reference selected.
  567.           0 - ASC val of reference type
  568.           1 - ref start column
  569.           2 - ref line number
  570.           3 - ref column after end
  571.           4 - ASC val of key mapping
  572.           5 - [G] depth of reference
  573. &X      - X (column) from graphic seln         selcol()
  574. &x      - Text cursor column
  575. &Y      - Y (line) from graphic seln           selline()
  576. &y      - Text cursor line
  577. &Z      - Key pressed from graphic seln        selkey()
  578. &zn     - [G] Information about last graphic displayed
  579.         &z0 - should have a value of 127, else not valid image
  580.         &z1 - character cell depth (8,14 or 16 pixels)
  581.         &z2 - left column  \
  582.         &z3 - top row      /  the top left corner position
  583.         &z4 - width in character cells
  584.         $z5 - depth in character cells
  585. &#vstr  - Convert variable 'v' using string    convert(v,string)
  586.  
  587. **   n can be single letter variable name
  588.  
  589. 23. Expression operators
  590.  
  591. +,-,*,/,%                - arithmetic operators
  592. expr?true exp:false exp  - triadic operation
  593. expr!expr                - bitwise OR
  594. expr&expr                - bitwise AND
  595. expr^expr                - bitwise EXCLUSIVE OR
  596. @expr                    - 1's complement
  597.  
  598. -- Boolean expression operators - 1 if TRUE, 0 if FALSE ---
  599.  
  600. expra>exprb              - a greater than b
  601. expra<exprb              - a less than b
  602. expra=exprb              - a equal to b
  603. ~expr                    - not expr (0->1,1->0)
  604. #c                       - Truth of condition code 'c'
  605. "vxxxx"c                 - combined variable comparison and test
  606.  
  607. 24. Script control structures
  608.  
  609.       {ic               If true
  610.        - if c true statements -
  611.       }
  612.  
  613.       {nc               If false
  614.        - if c false statements -
  615.       }
  616.  
  617.       {ic               If true
  618.        - if c true -
  619.       }e{               Else
  620.        - if c false -
  621.       }
  622.  
  623.       {nc               If false
  624.        - if c false -
  625.       }e{               Else
  626.        - if c true -
  627.       }
  628.  
  629.       {wc               While true
  630.        - while c true -
  631.       }
  632.  
  633.       {uc               Until true
  634.        - until c true -
  635.       }
  636.  
  637.       {
  638.        - while c true, but at least once -
  639.       }wc               While true
  640.  
  641.       {
  642.        - until c true, but at least once -
  643.       }uc               Until true
  644.  
  645.       {wc               While c true
  646.        - while c true -
  647.        - until d true -
  648.       }ud               Until d true
  649.  
  650.       {                 Loop
  651.        - actions -
  652.       }
  653.  
  654.       {                 Loop
  655.        - actions -
  656.       }xc{              If true, exit loop
  657.        - actions -
  658.       }
  659.  
  660. 25. Conversion string commands
  661.  
  662. l      - convert to lowercase
  663. u      - convert to uppercase
  664. s      - strip superfluous spaces
  665. tv     - translate according to variable v
  666. rv     - remove characters in variable v
  667. ic     - (before command) conditional on 'c'
  668.  
  669. 26. Pattern Match operators
  670.  
  671. <             at start - match start of string
  672. >             at end - match end of string
  673. ?             match any character
  674. _             match one or more space or TAB characters
  675. (alt1/alt2)   match alt1 or alt2 (if only one, it is optional)
  676. [abc]         match 'a', 'b' or 'c'
  677. [^abc]        match any character but 'a','b' or 'c'
  678. [x-y]         match any char in range x to y (eg. [a-zA-Z] match letter)
  679. {             start of word
  680. }             end of word
  681. x#            zero or more of the character or subexpression x
  682. x+            one or more of the character or subexpression x
  683. *             any string (equivalent to ?#)
  684. \x            character 'x' (allows metachars to be used literally)
  685.  
  686. &             AND conjunction (if multiple searches enabled)
  687. !             OR conjunction (if multiple searches enabled)
  688.  
  689. 27. Conditions
  690.  
  691. e    equal                                _equal
  692. n    not equal                            _notequal
  693. g    greater than                         _greater
  694. l    less than                            _less
  695. d    defined                              _defined
  696. u    undefined                            _undefined
  697. c    contains                             _contains
  698. w    contained within                     _within
  699. m    pattern match                        _match
  700. f    pattern fail match                   _fail
  701. s    errorcode set                        _error
  702. o    error code O.K.                      _ok
  703. r    actn mod. returned string            _result
  704. b    actn mod. returned nothing           _noresult
  705. z    file operation failure               _filerror
  706. A-Z  Application flags
  707. v    [IDE] set during view mode           _viewmode
  708. i    [IDE] set for IDE only               _IDE
  709. x    [G] set for HG,HGI,HDG only
  710.  
  711. --- Local to frame ---
  712.  
  713. 0-9  local flags
  714. /    matching frame flag                  _matching
  715. :    frame has been visited               _visited
  716. <    frame over one screen                _overscreen
  717.  
  718.  
  719. 28. Reserved characters in Actions
  720.  
  721. ----- (character 2,3) ------   
  722.  
  723. @     Dynamic menu
  724. &     String function
  725. !     Read record
  726. =     Expression evaluation
  727. %     Environment variable
  728. ?     Prompted input
  729.  
  730. ----- (any character) -----------
  731.  
  732. $     Variable expansion token
  733. |     Action modifier pattern spec
  734. ^     (Within frame names) Hyperfile sep
  735. ;     Multiple action separator
  736.  
  737. ----- (In frame / note text) --------
  738.  
  739. ~     Reference and formatting flag
  740. $     Variable expansion token
  741. .     (At beginning of line) Keyword
  742.  
  743. 29. Options
  744.  
  745. O0 - 0 = Do not produce restart file      
  746.      1 = Use restart file for notes       
  747.      2 = Use for notepad, vars and frame  
  748.      3 = Save references and variables (not frame)
  749.      4 = Save variables only
  750. O1 - 0 = Show funct keys, but not symbols 
  751.      1 = Show symbols                     
  752.      2 = Use 1st letter. Func keys as for frame/list
  753.      4 = Immediate menus on top line      
  754. O2 - 0 = No backtrack recording           
  755.     +1 = Record backtrack
  756.     +2 = Extended backtrack (to page)
  757. O3 - 0 = No frame extns in notepad        
  758.     +1 = Add file name as ref extension
  759.     +2 = Suppress INS/DEL notepad actions
  760.     +4 = Insert / remove current frame always
  761. O4 - 0 = No autoreference                 
  762.      1 = Autoreference frame names        
  763.      2 = Application specified autoref    
  764.      4 = Autoreference global notes
  765. O5 - 0 = 'o' output to bottom line        
  766.      1 =  output to printer ( -p flag)    
  767.      2 =  to standard text output         
  768.      3 =  to AUX device                   
  769.      4 =  to output file (opened by 'w')  
  770.     +8 = Suppress newline output
  771. O6 - 0 = exit without displaying memory   
  772.      1 = Display remaining space on exit  
  773.      2 = Swap HS/HG/HI to disk/XMS on DOS command
  774. O7 - 0 = No tracing                       
  775.     +1 = Trace script labels
  776.     +2 = [IDE] log actions / modifiers
  777.     +4 = [IDE] log condition tests
  778. O8 - 0 = Don't warn if item not found     
  779.      1 = Give warnings for item not found
  780.      2 = Give warnings for file not found
  781. O9 - 0 = 'T' listing interpret ref flags
  782.      1 = 'T' listing give verbatim list
  783.      2 = As 1, also strips 8th bit
  784.      3 = Display with flags and variables interpreted
  785.  
  786. 30. Extended options
  787.  
  788. O*0 - 0 = ESC key to input does not cancel
  789.      +1 = ESC key to input cancels script
  790.      +2 = Cause action modifier error to cancel multiple action
  791.      +4 = ESC key during script does not pause
  792. O*1 - 0 = No shadows on popups
  793.       1 = Shadow edges on popups
  794. O*2 - 0 = No blinking
  795.       1 = Blink mouse cursor
  796.       2 = Blink cursor and refs
  797. O*3 - 0 = Mouse cursor, keys step 1
  798.      +1 = Suppress mouse cursor
  799.      +2 = Cursor keys step as TAB
  800.      +4 = Put mouse on first ref. of frame text / paged list
  801.      +8 = Do not move mouse to selected reference
  802. O*4 - 0 = Autoref typed files
  803.       1 = Autoref files & frames
  804. O*5 - 0 = Accept characters < 128
  805.       1 =    less than 176
  806.       2 =    less than 256
  807. O*6 - 0 = Search all frames
  808.       1 = Search matching only
  809.       2 = Search frames not matched
  810.       3 = as for 1 and 2, but reset
  811.       4 =   to 0 after next search
  812.       5 to 9 - as 0 to 4 with non-stop
  813. O*7 - n = Tab width (1 to 9)
  814. O*8 - 0 = No comments on noted refs
  815.      +1 = Request comment on notes
  816.      +2 = Display matching line in search text list
  817.      +4 = Multiple search support (conjunctions)
  818. O*9 - 0 = Key mapping case sensitive
  819.       1 = Key mapping case insensitive
  820.  
  821. 31. Colour schemes
  822.  
  823. A      wB      Action reference
  824. B      Wk(bl)  Blink
  825. C      KC      Menu choice
  826. D      KW      Default title
  827. E      yK      Frame reference (replace)
  828. F      wK      Frame reference (stack)
  829. G      KK      Popup shadow edge
  830. H      KY      Menu heading
  831. I      yY      Input field
  832. J      KG      Note heading and border
  833. K      yG      Note
  834. L      RK      Low intensity
  835. M      KW      Menu reference
  836. N      gK      Note reference
  837. O      yB      Menu selection
  838. P      yr(bl)  Popup message
  839. Q      Kk(bl)  XOR mask for ref blink (O*22)
  840. R      KW      Request / message
  841. S      yG      Script reference
  842. T      WK      Frame text
  843. U      YK      (User 1)
  844. V      MK      (User 2)
  845. W      GK      (User 3)
  846. X      RK      (User 4)
  847. Y      BK      (User 5)
  848. Z      rK      (User 6)
  849.  
  850.  
  851. 32. Colour codes
  852.  
  853. K      Black                        _black
  854. B      Blue                         _blue
  855. G      Green                        _green
  856. C      Cyan                         _cyan
  857. R      Red                          _red
  858. M      Magenta                      _magenta
  859. Y      Yellow (Brown)               _yellow
  860. W      White (light grey)           _white
  861. k      Dark grey                    _grey
  862. b      Light blue                   _lightblue
  863. g      Light green                  _lightgreen
  864. c      Light cyan                   _lightcyan
  865. r      Light red                    _lightred
  866. m      Light magenta                _lightmagenta
  867. y      Light yellow                 _lightyellow
  868. w      Bright white                 _lightwhite
  869.  
  870. 33. Configuration strings
  871.  
  872. KH1 - Popup directory heading
  873. KH2 - '?' key mapping for frame display
  874. KH3 - '?' key for paged display (menuname)
  875. KH4 - ESCAPE mapping       [ZC]
  876. KH5 - HOME mapping         [y]
  877. KH6 - END mapping          [ZR]
  878. KH7 - PgUp mapping         [y-]
  879. KH8 - PgDn mapping         [y+]
  880. KH9 - Backspace mapping    [B]
  881. KH0 - Control menu heading
  882.  
  883. KG1 - Default action for RETURN / LEFT Mouse button
  884. KG2 - Default for RETURN / LEFT Mouse button in typed file
  885. KG3 - Default for ESCAPE / RIGHT button in typed file
  886. KG4 - End of title line for Type file and @G list
  887. KG5 - Variable expansion spec for @G formatted list
  888. KG6 - Selection expression for @G list
  889. KG7 - Format line for @G list
  890. KG8 - Character translation - from string
  891. KG9 - Character translation - to string
  892. KG0 - Frame transition script specification
  893.  
  894. 34. Control menu
  895.  
  896. KM1 - HOME
  897. KM2 - CONTENTS
  898. KM3 - BACKTRACK
  899. KM4 - SELECT BACK
  900. KM5 - NOTEPAD
  901. KM6 - SEARCH TEXT
  902. KM7 - TYPE FILE
  903. KM8 - DO ACTION
  904. KM9 - DOS SHELL
  905. KM0 - EXIT
  906.  
  907.  
  908. 35. Error codes
  909.  
  910. 1 - Operation cancelled
  911. 2 - No selection from menu
  912. 3 - End of file
  913. 4 - Cant open file
  914. 5 - File not open
  915. 6 - File open
  916. 7 - File changed
  917. 8 - At start of backtrack
  918. 9 - Divide by zero
  919. 10 - Value not expected
  920. 11 - Value expected
  921. 12 - Undefined opcode
  922. 13 - Unmatched parenthesis
  923. 14 - Syntax error
  924. 15 - Script not available
  925. 16 - Menu not available
  926. 17 - Note not available
  927. 18 - Frame not available
  928. 19 - Key not defined
  929. 20 - Invalid key code
  930. 21 - Local ref can't be noted
  931. 22 - Not at reference
  932. 23 - Key not mapped
  933. 24 - No action or disabled
  934. 25 - Invalid action code
  935. 26 - No command
  936. 27 - Env var not present
  937. 28 - Invalid dynamic menu
  938. 29 - Line too wide for screen
  939. 30 - String too long
  940. 31 - Too many lines in frame
  941. 32 - Max script reached
  942. 33 - Maximum menu size reached
  943.  
  944.  
  945. ================ INTEGRATED ENVIRONMENT REFERENCE =================
  946.  
  947. 36. Edit actions
  948.  
  949. #Atname~tafter    Add item and enter edit mode.         add(item,after)
  950. #atname~tfrom     Add item, copied from other           copy(item,from)
  951. #Bmessage         Load paged list message/edit string   before(string)
  952. #Ctname           Check item.                           check(item)
  953. #Ftname           Find item, set 'd' or 'u'             lookfor(item)
  954. #Mtname~tafter    Move item.                            move(item,after)
  955. #Dtname           Delete item.                          delete(item)
  956. #Utname~tafter    Undelete item.                        undelete(item)
  957. #Vtname           view item.                            view(item)
  958. #Etname           edit item.                            edit(item)
  959. #Onvalue          Edit option setting                   editopt(opt,val)
  960. #Lmmmmm;          Left margin default string for frame  lmargin(mmmmmm)
  961. #Wnn              Right margin default for frame        rmargin(nn)
  962. #Ptname           Print item, interpreting flags.       print(item)
  963. #ptname           Print item verbatim (no interp).      printv(item)
  964. #Rtname~tnewnm    Rename or change details.             rename(item,to)
  965. #TFframe~newtit   Change title string for frame.        rentitle(item,to)
  966. #Ztname           zap deleted item.                     zapdel(item)
  967. #X                save and exit.                        savexit()
  968. #Yfilename        save as 'filename' and exit           saveas(filename)
  969. #Q                quit with no saves.                   quitedit()
  970. #QQ               delete change file, and quit no save  quitedit(Q)
  971. #S                save file and continue.               save()
  972. #I                Incremental save.                     saveinc()
  973.                 - Save changes and index, can Q after this and
  974.                   index and changes will be read on next run of HI
  975. #Knnn string      Set config string (edit key mapping) setconfig(nn,str)
  976.  
  977. Parameters
  978.  
  979. 'tname' (and tafter etc) is made up of 't' and 'name'
  980. 't' is the item type specifier
  981.         N,n,M,m,S,s  -   as expected
  982.         F            -   FRAME
  983.         R            -   REMARK              t_remark()
  984.         E            -   END                 t_end()
  985.         P            -   PRINT directive     t_print(directive)
  986.         C            -   CHECK directive     t_check(settings)
  987.         T            -   Text file           t_file(filename)
  988.  
  989. Extra types
  990.  
  991. These types may be specified for certain operations
  992.         U           -   HEADER               t_header()
  993.         V           -   FOOTER               t_footer()
  994.         I           -   INDEX                t_index()
  995.         Z           -   SHARE                t_share()
  996.  
  997.  
  998. 37. Extra dynamic menus
  999.  
  1000. @I        Global item list                 globals()
  1001. @i        Local item list                  locals()
  1002. @Z        Deleted item list                deleted()
  1003.  
  1004. @P{n}{title}  Global item popup menu       globalpop(n,title)
  1005. @p{n}{title}  Local item popup menu        localpop(n,title)
  1006.               Values for 'n' are
  1007.               0        MENU
  1008.               1        NOTE
  1009.               2        SCRIPT
  1010.               3        PRINT
  1011.               4        CHECK
  1012.               5        REMARK
  1013.               6        END
  1014. @Ystring      Global item search           searchglob(string)
  1015. @ystring      Local item search            searchloc(string)
  1016. @U            Check frame texts            checkframes()
  1017. @V            Check global items           checkglobal()
  1018. @v            Check local items            checklocal()
  1019.  
  1020. 38. Flags in lists
  1021.  
  1022.       blank    Item is in original file
  1023.       M        Item is in memory
  1024.       C        Item is in the change file
  1025.       R        Item is readonly control item (not displayed)
  1026.       ?        Item failed last scan check
  1027.  
  1028. 39. Extra Functions
  1029.  
  1030. &f{d}           Free space on default (specified) drive
  1031. &l              Length of current hyperfile
  1032. &idefault       Input text from current screen position
  1033.  
  1034. &0 to &9        Edit mode variables
  1035.                 0 is macro
  1036.                 1 is search string
  1037.                 2 is replace string
  1038.                 3,4 are user definable
  1039.                 5 is edited item name
  1040.                 6 is edited item type name
  1041.                 7 is last deleted (part) line
  1042.                 8 is kill buffer
  1043.                 9 is left margin
  1044.  
  1045. 40. Environment options
  1046.  
  1047. Set via #Onvalue, where n is one of
  1048.   0  1       Create backup on save (set by -eb)
  1049.   1  0       (Create file -ec)
  1050.   2  1       scrollbar (0 = none, 1 = scrollbar)
  1051.   3  0       assumed indent (for edit mode/checks)
  1052.  
  1053. Run option values for &R
  1054.     28        Edit location (0 = in memory, 1 = from file '-ef')
  1055.     29        Number of edits so far
  1056.  
  1057. 41. Edit mode primitive function codes
  1058.  
  1059. A                Autoref global
  1060. a                Autoref local
  1061. B                Beginning of line
  1062. b                Beginning of word
  1063. C                Toggle cursor tracking (actual / displayed)
  1064. cspec            Convert according to 'spec' (see CALL extns)
  1065. D                Delete current char
  1066. d                Delete previous char
  1067. E                End of line
  1068. e                End of word
  1069. F                Autoref from frame list
  1070. ffspec           Append file
  1071. Gnn              Goto line number nn
  1072. gnn              Goto column nn
  1073. H                Toggle flag interpretation
  1074. hnspec           Popup note
  1075. I                Toggle Insert/Overwrite
  1076. iispec           Append item
  1077. J                Join lines
  1078. j                Fill / justify / centre paste buffer
  1079. K                Kill (delete) current line
  1080. kstring          Load kill buffer
  1081. L                Insert newline character
  1082. l                Set temp left margin
  1083. M                Toggle margins
  1084. m                Set position at mouse (or scrollbar)
  1085. N                Next page
  1086. n                Next line
  1087. O                open line before
  1088. o                open line after
  1089. P                Prev page
  1090. p                Prev line
  1091. Q                Quit edit
  1092. q                Save edit buffer to EDITBUFF.SAV
  1093. R                Refresh screen
  1094. r                Set temp right margin
  1095. S                Toggle symbol shift
  1096. ssspec           Insert string
  1097. T                Insert TAB character
  1098. tfspec           Append text screen
  1099. U                Undelete line as separate line
  1100. u                Undelete line inline
  1101. V                Verbatim character (from keyboard)
  1102. v                Verify (Check) edit buffer
  1103. W                wipe reference flags from word
  1104. wfspec           Append screen with attributes
  1105. X                Exit edit with save
  1106. xsspec           Execute function string
  1107. Ymessage         Ask for confirmation (multiple action line)
  1108. ystring          Search for string and position cursor 
  1109. Z                Delete to start of line
  1110. z                Delete to end of line
  1111.  
  1112.  
  1113. 0                User settable
  1114. 1                  edit mode
  1115. 2                  variables for
  1116. 3                  use with &0 to &4
  1117. 4                  functions
  1118. #                Store current column,line in &3,&4
  1119. .                Mark start line
  1120. -                Cut from start line
  1121. +                Paste cut lines
  1122. ^                Paste first line 'in line'
  1123. /filename        Save paste buffer to named file
  1124. =c               actual character 'c'
  1125. *                copy character from mouse position
  1126. <                Previous char
  1127. >                Next char
  1128. {                Beginning of paragraph (first line)
  1129. }                End of paragraph (last line)
  1130. (                Start of repeat range (must have ; after)
  1131. )                End of repeat range (end of multi-string)
  1132. !action          Do action (limited actions only !!!)
  1133.  
  1134.  
  1135. Parameters - nspec,fspec,sspec,ispec
  1136.  
  1137.  
  1138. Can be a literal string or from action modifier
  1139.  
  1140. nspec        Note spec = tname,Nname,nname
  1141. ispec        Item spec = nname,Nname,mname,Mname,sname,Sname,Fname
  1142. fspec        File spec = filename.ext
  1143. sspec        String = any string
  1144.  
  1145.  
  1146. 42. Graphics characters showing mappings in Symbol shift
  1147.  
  1148.  
  1149. `abcdefghijklmnopqrstuvwxyz+,./{}|  3 4 5 6 7 8 9 = ; : @ < >
  1150. αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈°∙·½¼«»√²ⁿ  │ ┤ ╡ ╢ ╖ ╕ ╣ ╜ ╗ ║ └ ╝ ╛
  1151.  
  1152.  
  1153. A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
  1154. ┴ ┬ ├ ─ ┼ ╞ ╟ ╚ ╔ ╩ ╦ ╠ ═ ╬ ╧ ╨ ╤ ╥ ╙ ╘ ╒ ╓ ╫ ╪ ┘ ┌
  1155.  
  1156.  
  1157.   ┌─┬─┐  ZDBD?   ╔═╦═╗  IMKM;   ░  0        â ä à å Ä Å á
  1158.   ├─┼─┤  CDED4   ╠═╬═╣  LMNM9   ▒  1        Ç ç
  1159.   │ │ │  3 3 3   ║ ║ ║  : : :   ▓  2        é ê ë è É
  1160.   └─┴─┘  @DADY   ╚═╩═╝  HMJM<   █  [        ï î ì í
  1161.                                             ¢ £ ¥ ₧ ƒ ⌐ ¬ ¡
  1162.   ╒═╤═╕  UMQM8   ╓─╥─╖  VDRD7   ▌  ]        ô ö ò Ö ó
  1163.   │ │ │  3 3 3   ║ ║ ║  : : :   ▐  ^        ü û ù Ü ú
  1164.   ╞═╪═╡  FMXM5   ╟─╫─╢  GDWD6   ▀  _        æ Æ
  1165.   ╘═╧═╛  TMOM>   ╙─╨─╜  SDPD=   ▄  \        ÿ ñ Ñ ª º ¿
  1166.  
  1167.  
  1168. 43. Default Key Mappings
  1169.  
  1170. Enter                      - Insert new line / break current line
  1171. Backspace                  - Delete previous character
  1172. Escape or Right Mouse      - Edit menu
  1173. LEFT Mouse                 - Position cursor / use scrollbar
  1174. Cursor Up,Down,Left,Right  - Prev line, Next line, Prev char, Next char
  1175. Home, End                  - Beginning of line, End of line
  1176. Ctrl Home, Ctrl End        - Go to start of word, end of word
  1177. Page Up, Page Down         - Previous page, Next page
  1178. Ctrl PgUp, Ctrl PgDn       - Go to start, end of buffer
  1179. Insert                     - Toggle Insert mode
  1180. Delete                     - Delete next character
  1181. Ctrl Left, Ctrl Right      - Delete to start, end of line
  1182.  
  1183. 44. Control Keys
  1184.  
  1185. ^A    - open new line After current
  1186. ^B    - open new line Before current
  1187. ^D    - Delete inline (from ^X position)
  1188. ^E    - Enter EDIT command
  1189. ^F    - reformat paragraph
  1190. ^G    - Toggle flag interpretation
  1191. ^J    - Join current line to next line
  1192. ^K    - Kill (delete) current line
  1193. ^L    - Set temporary Left margin
  1194. ^N    - Save edit buffer to file EDITBUFF.SAV
  1195. ^O    - Toggle margins (clear temporary margins)
  1196. ^Q    - Quote verbatim character (next char typed)
  1197. ^R    - Set temporary Right margin
  1198. ^T    - Toggle cursor Tracking (actual / visible char)
  1199. ^U    - Undelete line
  1200. ^V    - Verify (check) buffer
  1201. ^W    - Wipe reference flags
  1202. ^X    - Mark start for inline cut (^D to cut)
  1203. ^Y    - paste in line
  1204. ^Z    - duplicate character from mouse position
  1205.  
  1206. 45. Function Keys
  1207.  
  1208.       UNSHIFTED      SHIFT(flag as)  CONTROL (insert)  ALTERNATE
  1209. F1  - Help menu      Frame step      Frame reference   Frame autoref
  1210. F2  - Refresh        Frame ref       Global item ref   Global note autoref
  1211. F3  - Macro (check)  Global note     Local item ref    Local note autoref
  1212. F4  - Swap with mark Local note      Append Frame      Search/replace
  1213. F5  - Mark for cut   Global menu     App Global item   Search again
  1214. F6  - Cut from mark  Local menu      App Local item    Search for string
  1215. F7  - Paste lines    Global Script   App File text     Copy to kill
  1216. buffer
  1217. F8  - Symbol shift   Local Script    App Screen file   Paste kill buffer
  1218. F9  - QUIT edit      Action          App Screen (att)  DOS exit
  1219. F10 - Save & exit    Input field     App saved buffer  Save PASTE buffer
  1220.  
  1221. ---------------- COMMAND LINE OPTIONS --------------------
  1222.  
  1223. 46. HS - HyperShell Reader
  1224.  
  1225. hs {options} hyperfile {frame}
  1226.  
  1227.   -n  Restart file for notes  
  1228.   -r  Restart for notes,variables,frame
  1229.   -s  Save screen for redisplay on exit
  1230.   -m  Force use of mouse emulator
  1231.   -f  Suppress symbols on menus
  1232.   -b  Suppress backtrack recording
  1233.   -a  Switch on autoreferencing
  1234.   -u  Display available memory on exit
  1235.   -x  Suppress file suffix on notepad
  1236.   -t  Trace labels in scripts
  1237.   -h  MDA/Hercules/mono EGA/VGA highlighting scheme
  1238.   -g{n}  CGA/EGA highlighting scheme
  1239.       (n=0-CGA,1-Herc,2-EGA,3-VGA)
  1240.   -z  Flash mouse cursor
  1241.   -l  Verbatim Type file listing
  1242.   -k  Verbatim and strip 8th bit
  1243.   -d  Use BIOS for display
  1244.   -q  Stop Crl-C/Ctrl-Break
  1245.   -vVstring Set variable V to string
  1246.  
  1247. 47. HI - HyperShell Integrated Environment
  1248.  
  1249. hi {options} hyperfile {frame}
  1250.  
  1251.   OPTIONS AS FOR HS - PLUS
  1252.  
  1253.   -ef   Work against file, rather than in memory
  1254.   -eb   Delete original, rather than saving as .BAK
  1255.  
  1256. 48. HC - HyperShell Checker
  1257.  
  1258. hc {options} hyperfile
  1259.  
  1260.   -t            suppress audit trail
  1261.   -h            translate .HSL source to .HYP first
  1262.   -j            just translate .HSL file
  1263.   -dname=defn   define source variable (name=val)
  1264.   -ifile        include file
  1265.   -l            list complete hyperfile
  1266.   -n            suppress line numbers in listing
  1267.   -e            list with embedded errors, (sets -l, -n and -o)
  1268.   -c            create unrefd frames etc
  1269.   -u            suppress error messages for unrefd items
  1270.   -g            extended autogeneration (sets -e -c -u -o)
  1271.   -b            autoreference
  1272.   -k{xxx}       extended autoreference (sets -l -n -u -b -o)
  1273.                 x=f-frames,n-notes,m-menus,s-scripts
  1274.   -y            interactive autoreference
  1275.   -o            produce file filename.CHK
  1276.   -a            do action checks for menus with actions
  1277.   -x            suppress menu length check
  1278.   -f            do frame reference checks for menus without actions
  1279.   -p            suppress frame length check (paged frames)
  1280.   -r            produce reference counts
  1281.   -s            suppress summary totals
  1282.   -z            produce cross reference file
  1283.   -m            suppress duplicate checks
  1284.   -q            suppress unreferenced item list
  1285.   -w            suppress warnings
  1286.  
  1287. 49. HP - HyperShell Print program
  1288.  
  1289. hp {options} hyperfile {frame name}
  1290.  
  1291.   -p  output straight to printer
  1292.   -e  output to printer using Epson effects
  1293.   -z  output to printer using Laserjet/Deskjet effects
  1294.   -l      with -p, -z or -e, set letter quality
  1295.   -tn  assume tab size of 'n'
  1296.   -mn  assume left margin on frames of n
  1297.   -hnn  page height nn rather than 66
  1298.   -s  soft formfeeds
  1299.   -n  Do not do page breaks, or index
  1300.   -w  Format for word processor (sets -n)
  1301.   -d  use default heading, rather than first title
  1302.   -r  list reference details after frame
  1303.   -g  include notes (glossary)
  1304.   -f  full list including items
  1305.   -o  print one frame (with notes if -f)
  1306.   -i  ignore print directives
  1307.   -a  stop and ask before each new page
  1308.   -v  configuration file diagnostic display
  1309.   -cfilename  use filename{.hsf} as list of frames to print
  1310.               if no filename use RESTART.HSF
  1311.   -j  ignore ~p flags
  1312.   -b  Page break for each frame
  1313.   -k  Do not print frame side headings
  1314.   -usssss  Left title string
  1315.  
  1316. 50. HCX - HyperShell Compress program
  1317.  
  1318. hcx {-c/-r/-s){-x/-p/-o/-n}{-t} file
  1319.  
  1320.   COMPRESSION
  1321.    -c   compress
  1322.    -r   rename
  1323.    -s   secret (one way compression for primary hyperfile only)
  1324.   EXPANSION
  1325.    -x   expand to file
  1326.    -p   paged display
  1327.    -o   expand to output
  1328.    -n   just show filename
  1329.   BOTH
  1330.    -t   remove/add <CR> chars
  1331.  
  1332. 51. TAGBLOAD - BLOAD image tagger
  1333.  
  1334. tagbload filename.ext {mode}
  1335.  
  1336.  Mode           Resolution        Colours
  1337.  
  1338.  0 or 1       40x25   text     - 16
  1339.  2 or 3       80x25   text     - 16
  1340.  4 or 5       320x200 graphics - 4
  1341.  6            640x200 graphics - 2  
  1342.  7            80x25   text     - Monochrome with attributes
  1343.  7            720x350 graphics - Hercules monochrome
  1344.  13           320x200 graphics - 16
  1345.  14           640x200 graphics - 16          (1 showing)
  1346.  15           640x350 graphics - 4
  1347.  16           640x350 graphics - 16          (1 showing)
  1348.  17           640x480 graphics - 2
  1349.  18           640x480 graphics - 16          (1 showing)
  1350.  54 to 59  and other special modes may also work, depending on adaptor
  1351.  
  1352. 52. HYPOP - HyperShell subset popup program
  1353.  
  1354.   hypop filename.ext           install
  1355.   hypop -u                     uninstall
  1356.  
  1357. Invocation Hotkey is Alt-/
  1358.  
  1359. Subset specification
  1360.  
  1361.  .FRAME name (up to 35)
  1362.  .TITLE title string (up to 35)
  1363. Text up to 22 lines of 79 columns maximum (truncated).
  1364. Default mode referencing uses reference flags ~F and ~E
  1365.    .REMARK AUTO           - Automatic mode referencing
  1366.    .REMARK LINES nn       - Set part screen depth
  1367.    .REMARK SCHEME nFB.    - Set colour scheme n is one of:-
  1368.         0 = Main display text
  1369.         1 = Title
  1370.         2 = Reference
  1371.         3 = Highlighted reference
  1372.   .REMARK OPTION n        - Set options where n is one of:-
  1373.         1           - F9 will NOT leave screen on display
  1374.   .REMARK TEXT nn New text string    - Configure text
  1375.  
  1376. Operation
  1377.   Keys TAB, BackTAB, cursors, alphabetic keys, to move.
  1378.   RETURN to select.
  1379.   PgUp PgDn and Home move about pages of frame
  1380.   End redisplays the saved screen
  1381.   + and - move to next and previous frames.
  1382.   F1 goes to frame 'Help' (or 1st frame if none)
  1383.   F2 goes to first frame and resets backtrack
  1384.   F3 is backtrack
  1385.   F4 toggles part/full screen
  1386.   F6 asks for a context word to search for
  1387.   F9 exits, leaving screen on display
  1388.   F10 key or the ESCAPE key exits
  1389.  
  1390. 53. HRXFP - HyperShell Floating Point
  1391.  
  1392. hrxfp -i             install
  1393. hrxfp -u             uninstall
  1394.  
  1395. ---- Functions
  1396. sin, cos, tan, atan, asin, acos, log, ln, sqrt, exp
  1397. abs, floor, ceil, rand
  1398. c_i, i_c       centimetre, inch
  1399. m_f, f_m       metre, foot
  1400. k_m, m_k       kilometre, mile
  1401. k_p, p_k       kilogram, pound
  1402. g_o, o_g       gram, ounce
  1403. l_g, g_l       litre, gallon
  1404. d_r, r_d       degree, radian
  1405. c_f, f_c       centigrade/celsius, fahrenheit
  1406. ---- Options
  1407. #d - decimal
  1408. #o - octal
  1409. #x - hexadecimal
  1410. #b - binary
  1411. #c - character
  1412. #pn - decimal places
  1413. #snnn - set random seed as nnn
  1414.  
  1415. 54. NGHS - Norton Guide to hyperfile convertor
  1416.  
  1417.     nghs {flags} guidename.ng
  1418.  
  1419.       -m    Local menu for See Also references
  1420.       -v    verbose
  1421.       -p    popup
  1422.       -a    adjacent titles
  1423.       -tnn  title position
  1424.  
  1425. 55.   NOTE - Simple note editor
  1426.  
  1427.      note {options} filename.ext
  1428.  
  1429.       -ttitle     Title string (default=filename)
  1430.       -lline      Start line for window
  1431.       -ddepth     Depth in lines
  1432.       -ccolumn    Start Column for window
  1433.       -wwidth     Width in Columns
  1434.       -bborder    Border style for window (0 to 9)
  1435.       -sFBfb      Highlighting schemes
  1436.       -a          Start in autoformat mode
  1437.       -v          View mode - no edits
  1438.       -f          fold overlength input lines (otherwise truncated)
  1439.       -rnn        restrict editing to max nn lines
  1440.       -h          Help display
  1441.  
  1442.   Edit control keys
  1443.  
  1444.       ESC         - Menu bar
  1445.       cursor keys - up,down,left,right
  1446.       PgUp,PgDn   - Prev, Next page
  1447.       Home,End    - Start,End of line
  1448.       Ctrl-Home   - Start of file
  1449.       Ctrl-End    - End of file
  1450.       Ctrl-T      - Top of window
  1451.       Ctrl-B      - Bottom of window
  1452.       Ctrl-Right  - Next word
  1453.       Ctrl-Left   - Previous word
  1454.       Ins         - Insert / Overwrite
  1455.       Del         - Delete next char
  1456.       Backspace   - Delete prev char
  1457.       Ctrl-A      - Auto format
  1458.       Ctrl-F      - Format para
  1459.       Ctrl-N      - New (clear buffer)
  1460.       Ctrl-D      - Delete word
  1461.       Ctrl-Y      - Delete line
  1462.       Ctrl-Q      - Quit, no save
  1463.       Ctrl-X      - Exit with save
  1464.       Ctrl-V      - Allow entry of graphic characters
  1465.       Ctrl-L      - Line draw toggle
  1466.       F1          - Help
  1467.       F2          - Begin block
  1468.       F3          - End of block
  1469.       F4          - Unmark block
  1470.       F5          - Move block
  1471.       F6          - Copy block
  1472.       F7          - Delete Block
  1473.       F8          - Delete Line
  1474.       F9          - Quit, no save
  1475.       F10         - Save and exit
  1476.  
  1477. 56.   HSORT - Hyperfile index sort
  1478.  
  1479.       hsort source.hix target.ext {type}
  1480.  
  1481.       type is:-
  1482.       0 (default)  produce .HIX format
  1483.       1            produce .HIX format (sort case insensitive)
  1484.       2            produce contents list format with key mappings
  1485.       3            contents format (sort case insensitive)
  1486.       4            produce data file format frame~title~address
  1487.       5            data file format    (sort case insensitive)
  1488.       above + 8    do not do sort - output unsorted
  1489.  
  1490. 57.   HSHOW - Graphic file display program
  1491.  
  1492.       hshow {flag} filename.ext {flag} filename.ext . . .
  1493.       Where flags are:-
  1494.  
  1495.           +     reset to text mode after following image(s) (default)
  1496.           -     leave in graphics mode after following image(s)
  1497.           =     do not wait for key press on following image(s)
  1498.  
  1499. 58. HPREP - Text preparation program
  1500.  
  1501.   hprep {options} infile.ext {outfile.ext}
  1502.  
  1503. 1.      -h       Fill hyperfile frame and note text
  1504.         -inn     Note Indent (0), -nnn  Note Width (40), -v Verbose
  1505.         [In hyperfile:- .REMARK FORMAT OFF/ON]
  1506. 2.      -f{x}    Fill text file (x=c-centre,x=j-justify)
  1507. (1,2)   -lnn     Left margin (8),  -rnn   Right margin (72)
  1508. 3.      -c       Clean file (strip trailing spaces etc)
  1509. 4.      -w{nn}   Wrap long lines at nn (72)
  1510.         -a{cc}   (with w) extract ASCII characters (cc = classes)
  1511.         Class x-alnum,l-alpha,a-(0-127),t-tab>spc,c-ctrl(0-31),s-spc/ff
  1512.         d-digs,p-prtblr,g-graph,f-accent/greek,m-maths,e-extd(>127)
  1513. 5.      -x{nn}   Extract text strings of length nn (3) or greater
  1514. (4,5)   -u       Fold 8 bit to 7 bit chars before processing
  1515. 6.      -t{n}    Detab file at tab 8 {n = at tab size n}
  1516. 7.      -s oldstr newstr    Replace oldstr with newstr
  1517. 8.      -d{p}    Hexadecimal dump of file {paged}
  1518. 9.      -j{XX}   Join files (X=F-.FRAME,T-.TITLE,N-.NOTE,Z-File)
  1519. 10.     -z from to   Convert from ASCII value to ASCII value
  1520. 11.     -p{x}    Join lines in paragraph (for word processor)
  1521. 12.     -e from to   Extract range of lines from text file
  1522. 13.     -b       Count items in file (no output file)
  1523. 14.     -m       Convert to mixed case text
  1524. 15.     -q key   Encrypt or Decrypt a text file using a key
  1525. (All)   -o       Overwrite output file
  1526.  
  1527. 59. HSPELL - Hyperfile spell check
  1528.  
  1529.      hspell {options} file
  1530.      options
  1531.  
  1532.      -t             check a normal text file
  1533.      -e             extract text from hyperfile for other purposes
  1534.      -v             print plausible derivations (only use with t)
  1535.      -x             print plausible stems (only use with t)
  1536.      -D dict        specify alternate dictionary
  1537.      -I index       specify alternate index file
  1538.      -R rule        specify alternate rule file
  1539.      -C cachesize   word cache size
  1540.      -g             include graphic characters in check
  1541.      -i             produce item list instead of editor input file
  1542.  
  1543. 60.   HFIND - File and text finder
  1544.  
  1545.    hfind options string file.ext
  1546.    options
  1547.  
  1548.      -i           get file names from standard input
  1549.      -c           case sensitive search
  1550.      -t           display count of matching lines only
  1551.      -f filename  read search strings from filename
  1552.      -n           display names of files containing the string
  1553.      -o           display byte offset of matching strings
  1554.      -s           silent - return only success (0) or failure (1)
  1555.      -w           display matching whole lines only
  1556.      -e string    next parameter is search string
  1557.      -p           suppress display of file names
  1558.      -h           produce HyperShell selection list
  1559.      -b           HTYPE file reference list
  1560.      -r           search files in subdirectories as well
  1561.      -g           do global search of whole disk
  1562.      -l           locate filenames on disk
  1563.                   (if used with -r, just subdirectories of current)
  1564.      -a           restrict search to files with archive bit set
  1565.      -d command   confirm and perform command on file
  1566.      -q           with -d, don't confirm before performing command
  1567.  
  1568. search responses
  1569.  
  1570.       space   continue - will resume the function
  1571.       s       skip - continue, skipping this file/directory
  1572.       q       quit - will stop the function
  1573.       c       will change to the displayed directory and quit
  1574.       a       if doing commands, confirm each before processing
  1575.       other keys  quit - will stop the function
  1576.  
  1577. confirmation responses:-
  1578.  
  1579.       y       yes - perform the command
  1580.       Enter   yes - perform the command
  1581.       g       yes - do this, and continue without confirmation
  1582.       n       no  - continue search
  1583.       s       skip - skip rest of this file
  1584.       q       quit - stop search
  1585.       Escape  quit - stop search
  1586.       c       change directory and stop
  1587.       other key - continue search
  1588.  
  1589. 61. HTYPE - File browser
  1590.  
  1591.    htype {options} {filename.ext}
  1592.    options
  1593.  
  1594.    -fstring      find string in file
  1595.    -lnnn         Goto line nnn in file
  1596.    -snnnn        Start at line nnnn as line 1
  1597.    -w            Wrap text to fit page
  1598.    -x            Display text in binary file
  1599.                  and wrap text to fit page
  1600.    -m            Suppress mouse handling
  1601.    -d            Show detail line for files
  1602.  
  1603. Configuration scheme numbers
  1604.  
  1605.    0   - normal colour    - main file display text
  1606.    1   - highlight colour - file detail line in picklist
  1607.                           - search items located in file display
  1608.    2   - inverse colour   - top / bottom border, current picklist item
  1609.    3   - blink colour     - error messages
  1610.    4   - picklist colours - text in picklist
  1611.    5   - help colours     - text in help displays
  1612.  
  1613. PickList mode key mappings
  1614.  
  1615.      F1          - Help display
  1616.      F2          - Display A - Z mappings
  1617.      F3/DEL      - Move up one directory level
  1618.      F4          - Exit at current directory
  1619.      F5          - Find file using HFIND -l
  1620.      F6          - Find string in files using HFIND
  1621.      F7          - Toggle binary/text viewing
  1622.      F8          - Prompt for command and run on file
  1623.      F9          - DOS Shell escape
  1624.      F10/ESC     - Quit
  1625.      TAB         - Toggle file details display
  1626.      Cursors     - Move around files
  1627.      Enter       - Select file for viewing
  1628.      PgUp / PgDn - Previous / Next page of files
  1629.  
  1630. File display mode key mappings
  1631.  
  1632.      F1             - Help display
  1633.      F2             - 
  1634.      F3             - Backtrack to previous file (if file reference)
  1635.      F4             - Exit in current directory
  1636.      Home           - Top of file
  1637.      PgUp           - Up one Page
  1638.                         Up  ^  Line
  1639.      Cursors     Left 10 <  +  > Right 10 chars
  1640.                       Down  v  Line
  1641.      Ins            - Left edge
  1642.      PgDn or SPACE  - Down one Page
  1643.      End            - Bottom of file
  1644.      / or F6        - Scan (case sensitive)
  1645.      \ or F7        - Find (case insensitive)
  1646.      F5             - Find / Scan next
  1647.      TAB            - Toggle fold on search string
  1648.      #              - Go to line number
  1649.      [              - Mark block start
  1650.      ]              - Mark block end
  1651.      -              - Clear block marks
  1652.      >              - Write block to file
  1653.                       (give filename of PRN to print block)
  1654.      =              - Go to block start
  1655.      F8             - Run command on file (asks for command)
  1656.      F9             - DOS Shell
  1657.      q, Esc or F10  - Exit HTYPE program
  1658.      f or RETURN    - follow link at top line
  1659.      h              - follow link at mouse
  1660.      x              - re-enter in binary / text mode
  1661.      c              - continue truncated file
  1662.  
  1663. 62. HSRES - Resident swapper for HyperShell
  1664.  
  1665.   hsres {options}
  1666.   /1           single swap file
  1667.   /A           visible attribute for swap files
  1668.   /C           on-screen configuration
  1669.   /D           force disk swapping even if EMS/XMS available
  1670.   /Fkbytes     specify approx. kbytes free within DOS shell
  1671.   /Hhyperfile  specify hyperfile to activate. $-variables allowed
  1672.   /Khexkeys    specify TSR hot keys in hex
  1673.   /M           disable swap message
  1674.   /Pprogram    chose as program HS, HL or HI
  1675.   /Rframe      specify hyperfile frame to show. $-variables allowed
  1676.   /Spath       specify path for swap files. $-variables allowed
  1677.   /U           unload TSR
  1678.   /V           remove mouse management code
  1679.   /X           Choose XMS over EMS
  1680.   /? or ?      show the command line options
  1681.  
  1682. The "/" option prefix may be substituted by "-". Spaces are not allowed
  1683. inside command line options, and the options must be separated by
  1684. spaces.
  1685.  
  1686. The "switching" options, eg. /1, will switch the option back and forth
  1687. when mentioned several times. The other options, like /S, will retain
  1688. the value from the LAST time they are mentioned.
  1689.  
  1690. Options may be placed in a configuration file, as described below.
  1691.  
  1692.    $-variables - Transferring data to HSRES
  1693.  
  1694. You can transfer data from the running application to HSRES by means of
  1695. $-variables. These variables will be evaluated and replaced in the
  1696. HSRES configuration at the time of installation or popup.
  1697.  
  1698. There are four types of $-variables:
  1699.  
  1700.      $              Word from text cursor position
  1701.      $(x,y)         Word from x,y screen position
  1702.      $(?prompt)     Ask the user for a value
  1703.      $(EnvVar)      Value of environment variable
  1704.  
  1705. 63.   HPAINT - Paint program
  1706.  
  1707.    hpaint {options}
  1708.    options are as follows:-
  1709.  
  1710.     -l         low res - 640x200 in 16 colours
  1711.     -m         medium res - 640x350 in 16 colours
  1712.     -h         high res - 640x480 in 16 colours
  1713.     -c         CGA mono - 640x200 in monochrome
  1714.  
  1715.     The default mode is the highest resolution supported by the adaptor.
  1716.  
  1717.   Key mappings
  1718.  
  1719.   h/F1 - help display
  1720.   z/F3 - toggle control panel display / full screen
  1721.   s - stage save, for undo stages within tool selection
  1722.   u - undo to last tool selection
  1723.   c - clear screen
  1724.   m - show available memory
  1725.   P - Print screen as per PRNT selection set
  1726.   r - refresh (redraw) screen
  1727.   A - Adjust palette for foreground colour. Keys then as follows
  1728.       r - red up     R - red down
  1729.       g - green up   G - green down
  1730.       b - blue up    B - blue down
  1731.       1 thru 9  - set increment for above adjustments (default 1)
  1732.       d load default palette for the current colour
  1733.       # load default palette for ALL COLOURS
  1734.       u or U - undo change to current colour (since A was pressed)
  1735.   d/F2 - directory list for file type, allowing selection with mouse
  1736.   Q - quit without confirmation (use with care)
  1737.   F10 - quit with confirmation
  1738.  
  1739. 64.   HRESED - Resource editor
  1740.  
  1741.   Usage: resed {options} {filename.ext} {secondfont.ext}
  1742.    -it  icon - where t is:-
  1743.               wide deep (default is 32 by 32)
  1744.           n    24   28 (narrow EGA)
  1745.           w    32   28 (wide EGA)
  1746.           l    40   32 (large VGA = maximum)
  1747.           s    16   14 (small EGA)
  1748.           v    16   16 (small VGA)
  1749.    -wnn  width
  1750.    -hnn  height
  1751.    -tc   Set transparent background in .ICO to colour c
  1752.          (where c is in HyperShell colour set) else set transparent
  1753.    -m    mouse cursor - 16x2 by 16
  1754.    -fdd  font height dd = 8,14,16
  1755.    -onn  font at offset nn
  1756.    -cnn  convert an nn deep font to 16 (or -fdd depth)
  1757.          eg. hresed -c14 font8.udg font16.udg
  1758.              hresed -f8 -c14 font14.udg font8.udg
  1759.    -b    use the BIOS font for the main font (with -fdd) or the
  1760.          second (default) font when editing filename.udg
  1761.  
  1762.    Z command - global font processing options
  1763.      NOTE: if uppercase character is inverted before operation applied
  1764.  
  1765.         o     - OR current character with all characters in font
  1766.         a     - AND current character with all characters in font
  1767.         x     - XOR current character with all characters in font
  1768.         z     - no operation. Used as 'Z' to invert all characters
  1769.         m     - mirror character left->right and right->left
  1770.         f     - flip character top->bottom and bottom->top
  1771.         l     - shift character left one pixel
  1772.         r     - shift character right one pixel
  1773.         u     - shift character up one pixel
  1774.         d     - shift character down one pixel
  1775.         v     - rotate character for vertical print
  1776.         j     - clear alternate lines horizontally
  1777.         s     - superscript (condense character to upper half of cell)
  1778.         n     - shadow after character
  1779.         b     - bold horizontally
  1780.         h     - bold vertically
  1781.         i     - italic
  1782.         w     - wavy character
  1783.         _     - underline character
  1784.  
  1785. 65.  HGPREP - HyperShell Graphic Preparation
  1786.  
  1787.    Usage: hgprep {options} filename.ext
  1788.    options are as follows
  1789.  
  1790.         -i      Show information only
  1791.         -v      Show details of processing
  1792.         -c      Convert to PCX same number of colours
  1793.         -k      With -c, choose area to convert as 320x200
  1794.         -r{t}   Reduce 256col picture to PCX 16col
  1795.                 t is Dark threshold (1 to 4)
  1796.         -h{n}   Halftoning. Bright threshold n = 1 to 8 (default 4)
  1797.         -z      Random halftoning instead of checkerboard
  1798.         -bnn    nn = (-7 thru 7) - Adjust brightness
  1799.         -aadj   Adjust colours for conversion
  1800.                 rnngnnbnn  nn is % adjustment (-90 to 500)
  1801.                 eg. -ar20g-30  increase red by 20%, reduce green by 30%
  1802.         -q      Produce quad image (times 2)
  1803.                 (-a -b -h -q and -z are for use with -r)
  1804.         -sn     Supervga mode for showing large 256 colour GIF images
  1805.                 1 - Paradise, 2 - Trident, 3 - Tseng, 4 - ATI, 5 - vgahi
  1806.         -m      Convert 256 colour lowres .PCX to mode 19 .HGP
  1807.         -t      Convert 256 colour mode 19 .HGP to lowres .PCX
  1808.         -x      Extract palette from PCX (16 or 256)
  1809.         -p      Convert palette defn to PAL
  1810.         -o      Overwrite existing output (otherwise aborts)
  1811.  
  1812. 66.   HCOMP - Compression control
  1813.  
  1814.    Usage: hcomp flags filenames
  1815.      flags are:-
  1816.  
  1817.      -cext   compress files and add extension ext
  1818.      -f      force compress (used with -c)
  1819.              compress even if output is uptodate
  1820.      -xext   expand files and add extension ext
  1821.      -q      do it quietly - no messages
  1822.  
  1823. 67.  HLIB - Command line
  1824.  
  1825.    Usage: hlib {flags} libname filenames
  1826.      {flags} are:-
  1827.      -v   verbose audit trail
  1828.      -o   overwrite library
  1829.      -t   EOFs between text files
  1830.      -x   extract named files
  1831.      -l   list library
  1832.  
  1833.    Default library extension is .HLB
  1834.  
  1835.  
  1836. 68.   HCAP - capture screens
  1837.  
  1838.     HCAP  - capture any screen as one plane BLOAD
  1839.     HCAPX - capture any screen as one plane BLOAD
  1840.     HCAPPCX - capture colour and mono EGA/VGA screens as .PCX
  1841.               all 16 colour 640 pixel wide screens
  1842.     HCAPVGA - capture 256 colour 320x200 VGA as .HGP
  1843.  
  1844. 69. HFONT - Load font file for text mode
  1845.  
  1846.     HFONT fontname.udg {x}
  1847.  
  1848.     EGA requires 14 deep font
  1849.     VGA requires 16 deep font
  1850.  
  1851.     optional parameter x causes display of full character set after
  1852.     loading font.
  1853.  
  1854. 70.  HPG - Graphics print
  1855.  
  1856.      hpg l            - print screen to laserjet
  1857.      hpg e            - print screen to epson (not yet available)
  1858.      hpg f filename   - save screen to file as .PCX (no palette!)
  1859.  
  1860. 71.  CONVSND - Convert sound file
  1861.  
  1862. Usage: convsnd (fromname.ext) (toname.ext) [samplerate]
  1863.  
  1864.        samplerate is 11000 if not entered.
  1865.  
  1866. Valid input file types:
  1867.  
  1868.  .WAV       Microsoft WAVE file.
  1869.  .VOC       Soundblaster RAW .VOC file.
  1870.  .GSS       ???
  1871.  .SND       A raw file.
  1872.  .RAW       A raw file.
  1873.  .VMD       A raw file.
  1874.  .HSN       HyperShell format raw file.
  1875.  
  1876. Valid output types are .WAV, .RAW and .HSN.
  1877.  
  1878. 72.   CTaudio - Audio Compact Disc control for CD-ROM drives
  1879.  
  1880. Call: CTaudio <parameters>
  1881.  parameter:              meaning:                    returns EL:
  1882. --------------------------------------------------------------------------
  1883.  index                   tell disc contents          highest track no
  1884.  <track>                 play audio track            current track
  1885.  <fromtrack> <ToTrack>   play audio tracks           first track no
  1886.  <min:sec>               play from time              first minute
  1887.  <min:sec> <min:sec>     do. for specified time      first minute
  1888.                          Note: Format can also be <min:sec:frame>
  1889.  all                     play all tracks             first track no
  1890.  status                  show status once            current track
  1891.  status loop <row> <col> show continuous status
  1892.                          at screen pos (default 1,1) current track
  1893.  stop                    pause/stop audio            0
  1894.  resume                  resume audio from pause     0
  1895.  
  1896.  
  1897. CTaudio returns DOS Error Level (EL) > 100 on error conditions.
  1898. All output (except status loop) can be redirected to eg. nul.
  1899. Status loop mode can be changed with F1, and terminated by any other key.
  1900.  
  1901.  
  1902. 73. HyperShell File Extensions
  1903.  
  1904. .HYP            Hyperfile
  1905. .HIX            Hyperfile index
  1906. .MNU            Menu file
  1907. .HSF            Script file
  1908. .NTE            Note file
  1909. .CFG            Configuration file
  1910. .HXC            Integrated environment index file
  1911. .TMP            IDE temporary file
  1912. .BAK            IDE Backup file
  1913. .HCM            Compressed file default extn
  1914. .HXP            Expanded file default extn
  1915. .PIC            BLOAD image
  1916. .PCX            Microsoft Paintbrush image
  1917. .DAT            Database or data file
  1918. .TXT            Raw text file
  1919. .HSL            HSL source file
  1920. .HSI            HSL include file
  1921. .CHK            HC check output file
  1922. .XRF            Cross reference
  1923.  
  1924. [G] Graphic system files
  1925.  
  1926. .HGP            Bitmap clipping
  1927. .HMC            Mouse cursor
  1928. .UDG            Font file
  1929. .TIC            Draw sublanguage script (pixels)
  1930. .PAL            Palette file
  1931. .HLB            HyperShell library
  1932. .AGD            Supercompressed file
  1933. .HSN            HyperShell sound file
  1934. .BMP            Windows bitmap file
  1935. .ICO            Windows icon file
  1936. .WAV            Windows sound file
  1937.  
  1938. ===== END OF DOCUMENT =====
  1939.